LearningDataModel Class

An in-memory representation of the data model associated with one activity of one attempt of one package.

Namespace: Microsoft.LearningComponents.DataModel

Assembly: Microsoft.LearningComponents.dll

Syntax
C#

public class LearningDataModel

Properties
Name Description
Ð ActivityAttemptCount

Gets the number of attempts on the activity.

Ð CommentsFromLearner

Gets the list of comments from the learner about the learning experience.

Ð CommentsFromLms

Gets the list of comments generated by the LMS intended to be seen by all learners.

Ð CompletionStatus

Gets or sets whether the learner has completed the RLO.

Ð CompletionThreshold

Gets the threshold which indicates whether the RLO should be considered complete.

Ð Credit

Gets the credit setting for the data model.

Ð Entry

Gets or sets the entry mode for this RLO.

Ð EvaluationPoints

Gets or sets the points assigned by autograding or by the instructor for this activity.

Ð ExtensionData

Gets the extension data.

Ð Format

Gets format of the package associated with this data model

Ð Interactions

Gets the list of responses to individual questions or tasks.

Ð LaunchData

Gets the data from the manifest intended to provide an RLO with some initial launch information.

Ð Learner

Gets learner information and learner preferences.

Ð LessonStatus

Gets or sets the current student status as determined by the RLO.

Ð Location

Gets or sets location information which may be used as a bookmark within a RLO.

Ð MasteryScore

Gets the threshold which indicates whether the RLO should be considered complete.

Ð MaxTimeAllowed

Gets the maximum time allowed for this RLO.

Ð NavigationRequest

Gets the navigation request.

Ð Objectives

Gets the list of objectives for the activity, used to track RLO defined goals.

Ð ProgressMeasure

Gets or sets the measure of the progress the learner has made toward completing the RLO.

Ð ScaledPassingScore

Gets the scaled score required to master the RLO.

Ð Score

Gets the score for the data model.

Ð SessionTime

Gets or sets the session time for the current session of the RLO.

Ð SuccessStatus

Gets or sets whether the learner has mastered the RLO.

Ð SuspendData

Gets or sets data used to persist the current RLO state during a suspension.

Ð TimeLimitAction

Gets the action to take if MaxTimeAllowed is exceeded.

Ð TotalTime

Gets or sets the sum of all time spent in this RLO prior to the current session.

Methods
Name Description
Ð CreateComment

Creates a Comment object, which may then be used to be added to the CommentsFromLearner list.

Ð CreateCorrectResponse

Creates a CorrectResponse object, which may then be used to be added to the Interaction.CorrectResponses list.

Ð CreateInteraction

Creates a Interaction object, which may then be used to be added to the Interactions list.

Ð CreateInteractionObjective

Creates a InteractionObjective object, which may then be used to be added to the Interaction.Objectives list.

Ð CreateObjective

Creates a Objective object, which may then be used to be added to the Objectives list.

Ð CreateRubric

Creates a Rubric object, which may then be used to be added to an Interaction.Rubrics list.

Ð InteractionListContains

Determines whether or not the interactions list contains an element with the passed identifier.

Ð InteractionListElement

Returns the first interaction element found with the requested identifier within the interactions list.

Remarks

LearningDataModel represents the SCORM RTE data model data associated with one activity. In other words, a LearningDataModel instance represents information related to one learner's execution of one RLO within an attempt of one package.

LearningDataModel exposes the data model on an object derived from LearningSession. An application cannot directly create an instance of LearningDataModel or save the data stored within it. Instead, the application uses the CurrentActivityDataModel property of Microsoft.LearningComponents.Storage.StoredLearningSession to load a data model into memory, and one of various methods of Microsoft.LearningComponents.Storage.StoredLearningSession (such as CommitChanges) to save the data.

An activity's data model includes both read-only and read/write data. Read-only data comes from the package manifest or application and is not set by calls to LearningDataModel. Read/write data can be set the application or the RLO by calls to LearningDataModel. Some read/write data (including some objective information) is initialized from the package manifest but is read/write and can be overwritten by the application or RLO. A data model may also become entirely read-only in certain views (e.g. Review view) or if the data model is not associated with the currently active activity.